home *** CD-ROM | disk | FTP | other *** search
/ Logiciels PC Special 3 / Logiciel PC - Hors-Serie 3.iso / Logs / consoles / nes / rnes081a / ROCKNES.TXT < prev   
Text File  |  1999-04-04  |  13KB  |  371 lines
  1.  
  2.  ***************************************************************************
  3.  * RockNES 0.81a - A Nintendo Entertainment System 8-bit emulator for DOS  *
  4.  * Copyright (c)1998-99 Fx3 (fx3rnes@hotmail.com), Compiled on April/99    *
  5.  * Copyright (c)1997-98 Nicolas Hamel and others - original source code    *
  6.  ***************************************************************************
  7.  
  8. #ifndef _CREDITS_
  9. #define _CREDITS_
  10.  
  11. -> RockNES is Copyright 1998-99 by Fx3.
  12. -> DarcNES is Copyright 1998-99 by Alastair Bridgewater (a.k.a. Nyef).
  13.  
  14. -> Nintendo is trademark of Nintendo.
  15. -> The RockNES team is not affiliated with Nintendo or any other company,
  16.    nor advocate the piracy of Nintendo games.
  17. -> RockNES is freeware. You can to distribute it freely, as long as it is
  18.    non-modified. Commercial ROMs *NEVER* can be packaged with this emu.
  19. -> When you use this software you do so at your own risk. The author is
  20.    not responsible for any loss or damage resulting from the use or misuse
  21.    of this software.
  22.  
  23. -> If you do not agree with these terms, delete this software now.
  24.  
  25. Many games don't work correctly (or at all).
  26. Don't mail me case your favorite ROM doesn't work.
  27.  
  28. * RockNES uses a changed version of the DarcNES sound core (by Nyef). Please,
  29. send any comment, help or bug report to Nyef (nyef@softmail.net), or to me :)
  30.  
  31. #endif /* _CREDITS_ */
  32.  
  33. *---------------------------------------------------------------------------*
  34.  
  35. Index of \rocknes.txt
  36.  
  37.    I. Intro
  38.   II. History / Know problems
  39.  III. What RockNES does 
  40.   IV. ZIP file index
  41.    V. Hardware required
  42.   VI. Sintax / HOW TO USE ROCKNES / Game Genie
  43.  VII. ROM file format supported
  44. VIII. Greetings / THANKS
  45.   IX. http
  46.  
  47. *---------------------------------------------------------------------------*
  48.  
  49. ==========
  50.  I. /nTr0
  51. ==========
  52.  
  53. -> xNes is/was a Nintendo Entertainment System 8-bit emulator (NES), now it
  54. calls RockNES. It was firstly wrote for DOS, but ported later to Linux and
  55. MacOS. Six months after the last release, I, Fx3, decided to resume the DOS
  56. port, which is being currently supported, unless someone wants to port my
  57. emulator.
  58.  
  59. -> The compatibility of RockNES grows version after version. The goal of
  60. RockNES is to be a great emu: fast, compatible and FREE.
  61.  
  62. -> It's being coded fully in C and compiled with DJGPP/Allegro 3.11.
  63. Versions >0.5x are compiled with pgcc (gcc for Pentium).
  64.  
  65. *---------------------------------------------------------------------------*
  66.  
  67. =============
  68.  II. History
  69. =============
  70.  
  71. --------------
  72.  Version 0.81a
  73. --------------
  74.  
  75.         - Just redownload it.
  76.  
  77. -------------
  78.  Version 0.81
  79. --------------
  80.  
  81.         - Removed the new soundcard detection code (*can* destroy your HD!!!);
  82.         - Fixed Mapper #69 mirroring;
  83.         - F.A.Q. updated.
  84.  
  85. --------------
  86.  Version 0.80
  87. --------------
  88.  
  89.         - Fixed *major* PPU emulation problems. Many games are working now,
  90. like some Mapper #3 titles (Ghostbusters, Back to the Future). It should fix
  91. score/garbage problems (R.C. Pro AM 1 and 2) and glitches (Mapper #7 games),
  92. with a more accurate emulation;
  93.         - Fixed (*again*) virtual NES RAM size;
  94.         - Fixed trainer support;
  95.         - Frame rate default set to 2;
  96.         - Better (not full yet) sound support (sounds like a *real* NES);
  97.         - Fixed the sound card detection problem (when not initialised);
  98.         - Added Sunsoft Mapper #69 (Batman: Return of The Joker, press START
  99. to go to the main title);
  100.         - Mapper #1: fixed mirroring bug, thanks to Loopy;
  101.         - Mapper #3: it should work ok, *many* more games are working;
  102.         - Mapper #4: Major rewrite: IRQ bug fixed, no more SMB3 score garbage,
  103. Alien 3 is working with no problems, due the new VRAM switch system;
  104.         - Mapper #7: it should work ok. Use 256 scanlines per frame (-spf 256)
  105. for Battletoads games;
  106.         - Mapper #21 rewritten;
  107.         - Mapper #23: added partial IRQ support (Kid Dracula works);
  108.         - Mapper #25: added/fixed, working (Gradius ][);
  109.         - Mapper #64: fixed 2 bugs (VRAM switch related);
  110.         - Fixed `-f' option (frame rate), working again;
  111.         - Minor changes for the save/load state feature;
  112.         - Added 10 slots to save your game (press <F2> to select one);
  113.         - **New palette** (near a *real* NES color!);
  114.         - Fixed screen left clipping;
  115.         - F.A.Q. updated.
  116.  
  117. *============================================================================*
  118. to see past changes, check oldnews.txt
  119. *============================================================================*
  120.  
  121. ■ KNOW PROBLEMS:
  122.  
  123. -> There is a sprite bug (in some games, you can see little lines around some
  124. sprites).
  125. -> There is violet color in some games which would have blue color.
  126. -> If a game doesn't work, try to set the sound sampling rate.
  127. -> No frameskip (0) should cause an horrible speed and sound output.
  128. -> Partial NES sound emulation.
  129. -> Loading ROMs from a CD-ROM unit, RockNES won't be able to save anything.
  130. -> Mappers #16, #17, #71 and #91 not working (lack of info).
  131. -> Problems with score of some games (SMB, Twinbee3 and others);
  132. -> Some loss of sound data (triangle wave, volume sweep problem). 
  133.  
  134. ■ GOOD NEWS :)
  135.  
  136. -> Sound emulation (2 squares waves, 1 triangle wave and some noise);
  137. -> Screen clearing works fine (just play Ghosts'n Goblins!).
  138. -> Raster effects due the IRQ emulation fix (Rockman 6).
  139. -> Many games with score ok (Robocop, Double Dragon and Adv.Island games).
  140. -> Config file!
  141. -> Many video resolutions (from Allegro's stuff).
  142. -> You can select your video board (or AUTODETECT, from Allegro too).
  143. -> Inputs (Keyboard, Joystick and GamePad) totally configurable.
  144. -> Multiple screenshots by game loaded.
  145. -> Palette very closed to NES.
  146. -> *TONS* of games are now playable!!! :-)
  147. -> Real time (save/load feature) working!
  148. -> *Perfect* mid-frame VRAM writes (Top Gun 2, Super Mario Bros.3).
  149. -> *Perfect* sprite priority.
  150. -> Very good PPU emulation! (try mapper 7 games)
  151.  
  152. *---------------------------------------------------------------------------*
  153.  
  154. ========================
  155.  III. What RockNES does 
  156. ========================
  157.  
  158. ■ Currently:
  159. - The 6502 CPU emulation, provided by Marat Fayzullin <fms@cs.umd.edu>, bugs
  160. fixed by Nyef, some changes by me;
  161. - Scanline GFX engine;
  162. - Sprites 8x8 and 8x16, with priority working 100% good;
  163. - Trainer;
  164. - IO Ports (like joypads);
  165. - Sprite flipping & mirroring;
  166. - Fake color palette (not from a real NES);
  167. - Backed battery;
  168. - PPU scrollings;
  169. - Mappers 0-4, 7, 9-11, 15-18, 21-25, 32-34, 64-66, 68, 71, 78, 91.
  170. - Partial NES sound emulation (Square waves, Triangle wave and some noise).
  171.  
  172. ■ Extra features:
  173. - Game Genie codes;
  174. - Real time save/load state (now, 10 slots);
  175. - Snapshots.
  176.  
  177. ■ In the future:
  178. - Unknown.
  179.  
  180. *---------------------------------------------------------------------------*
  181.  
  182. ====================
  183.  IV. ZIP file index
  184. ====================
  185.  
  186. oldnews.txt => History of past RockNES updates.
  187. rocknes.txt => This file.
  188. rocknes.exe => The executable.
  189. rocknes.dat => The font.
  190.  
  191. *---------------------------------------------------------------------------*
  192.  
  193. ======================
  194.  V. Hardware required
  195. ======================
  196.  
  197. - A *fast* processor (Pentium or higher). I am using framerate=3 to get full
  198. speed and fine sound output in my Intel Pentium 166Mhz, 16Mb RAM;
  199. - A newer MS-DOS version (I don't know the minimum);
  200. - A sound card if you want NES sound emulation;
  201. - VESA 2.x or better (get Display Doctor at www.scitechsoft.com);
  202. - 8 MB of video RAM memory. I didn't tried it on 4 mb so...
  203.  
  204. *---------------------------------------------------------------------------*
  205.  
  206. => RockNES uses by default a VGA mode 320x200x8 to be more compatible with
  207. all videocards/monitors, but it's clipped. You can use a standard VGA
  208. graphics, ModeX, VESA, AUTODETECT etc.. The best resolution is 320x240 VBE/AF
  209. (use -vc 6 -vr 320 240). RockNES can autodetect your sound and video boards.
  210. VESA modes seems faster than any other.
  211.  
  212. example to get the best config with Mario:
  213.  
  214. rocknes mario -vc 6 -vr 320 240 -rate 1
  215.  
  216. *---------------------------------------------------------------------------*
  217.  
  218. =================================
  219.  VI. Sintax / HOW TO USE RockNES
  220. =================================
  221.  
  222. [USE RockNES AT YOUR OWN RISK !!]
  223.  
  224. rocknes <game> <options>. The options avaliable are:
  225.  
  226.  -f x     : Sets frame rate to x (default: 2) and disable AUTOFRAMESKIP.
  227.  -b x     : Forces the use of x as battery file.
  228.  -p1 x    : Forces input1: 1-KEYBOARD1, 2-JOYSTICK1, 3-GAMEPAD.
  229.  -p2 x    : Forces input2: 1-KEYBOARD2, 2-JOYSTICK2, 3-GAMEPAD.
  230.  -vc x    : Video card (see rocknes.cfg).
  231.  -vr x y  : Video resolution (x,y).
  232.  -cps x   : Sets the number of cycles per scanline (default=114).
  233.  -spf x   : Sets the number of scanlines per frame (default=256).
  234.  -nosound : No sound emulation/output.
  235.  -rate x  : Sound sampling rate - 1:22050 , 2:44100.
  236.  
  237. ■ RockNES will autodetect your soundcard.
  238. ■ See ROCKNES.CFG for other configuration options.
  239.  
  240. example to start mario.nes with a 640x480 resolution, 22050Mhz for sound,
  241. 113 cycles per scanline, 261 scanlines per frame, player 1 with a GamePad,
  242. video card type VGA:
  243.  
  244. rocknes mario -vr 640 480 -rate 1 -cps 113 -spf 261 -p1 3 -vc 1
  245.  
  246. *---------------------------------------------------------------------------*
  247.  
  248. The default keys are:
  249.  
  250. 'Z'     = B
  251. 'X'     = A
  252. 'ENTER' = Start
  253. 'Tab'   = Select
  254.  
  255. Use the keyboard arrows to control the direction.
  256.  
  257. <ESC> - POWER OFF  (quit to DOS)
  258. <F2>  - STATE SLOT SELECT (0..9)
  259. <F3>  - SAVE STATE    (to CartName.RNx, x is the slot)
  260. <F4>  - RESTORE STATE (from CartName.RNx, x is the slot)
  261. <F5>  - RESET
  262. <F12> - Snapshot to CARTN001.pcx (limit=999)
  263.  
  264. * NOTES:
  265.  
  266. - You're able to save 10 states/game loaded. The extension RNx will be added.
  267. Press <F2> to select a slot (0-9) and <F3> to save. Same for loading.
  268. `x' is the slot number, examples:
  269.  
  270. for game mario.nes... you press <F2> and select slot 2.
  271. press <F3> to save state to mario.rn2
  272.  
  273. press <F4> to load mario.rn2 (ok?)
  274.  
  275. !!! REMEMBER !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  276. !                                                          !
  277. ! - Old *.RNS files are *NOT* compatible with RockNES 0.74 !
  278. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  279.  
  280. '+' to increase Frame Rate (max=10);
  281. '-' to decrease Frame Rate (min=0).
  282. * NOTE: While a key is pressed, the emulator will stay paused.
  283.  
  284. *---------------------------------------------------------------------------*
  285.  
  286. Some notes:
  287.  
  288. -> The sound emulation core is "controlling" the NES frame rate. You will not
  289. have fast speed on powerfull machines.
  290.  
  291. -> If the emulation is slow on your machine, increase the frame rate for a
  292. value which gives you normal speed. I haven't a FPS counter yet...
  293.  
  294. -> Backed battery is automatically saved/loaded.
  295.  
  296. -> You can adjust the number of cycles_per_scanline/scanlines_per_frame to
  297. force some games to work/look better.
  298.  
  299. *---------------------------------------------------------------------------*
  300.  
  301. GAME GENIE
  302.  
  303. GameGenie codes can be either 6 or 8 digits and
  304. use the letters:
  305.     A P Z L G I T Y   E O X U K S V N
  306.  
  307. // To test game genie 6 char code - SXIOPO    Super Mario 1  Unlimited lives
  308. //                                  SXEZSKOZ  Super Mario 3  Skywalker
  309.  
  310. examples:
  311.  
  312. rocknes mario -gg SXIOPO
  313. rocknes smb3 -gg SXEZSKOZ
  314.  
  315. * You can't add/remove Game Genie codes during the emulation.
  316. * You *can* type (at command line prompt) something like:
  317.  
  318. rocknes megaman6 -gg LOOEKGPP -gg TOKENGLP -gg SXEEXTVG
  319.  
  320. (3 Game Genie codes will be enabled with Mega Man VI)
  321.  
  322. *---------------------------------------------------------------------------*
  323.  
  324. ================================
  325.  VII. ROM file format supported 
  326. ================================
  327.  
  328. - iNES for now (check the NES extension, or string in the ROM header).
  329.  
  330. *NOTE: Some games can be found with the .NEZ extension. Just rename them
  331. to .NES and good play... :-P
  332.  
  333. *---------------------------------------------------------------------------*
  334.  
  335. =================
  336.  VIII. Greetings  
  337. =================
  338.  
  339. - Marat for his 6502 emulator (m6502.c);
  340. - All the person behind DJGPP;
  341. - Shawn for Allegro 3.11;
  342. - Y0SHI for his nestech.txt.
  343.  
  344. Special thanks :
  345.  
  346. - Kritz for him GameGenie support and general help!
  347. - ReaperSMS (EFNet #mul8) for him help with save/load state feature fix and
  348. background render optimisations!
  349. - Nyef for him sound emulation core and general help;
  350. - [nesdev] Thanks for everybody!
  351. - \FireBug\ for him mappers.nfo file;
  352. - Loopy, Brad Oliver, Matt Conte, TrelaneQ and Roberto Rosario for their
  353. general help;
  354. - Zoop for him help with bankswitch, optimizations, nice font and RockNES'
  355. webpage hosting under Emulation Camp (www.emucamp.com);
  356. - All @people from IRC BrasNet #GameROM (www.end-br.org) and EFNet #mul8;
  357. - Nicolas Hamel and David M. for the original source;
  358. - All the peoples from old xNes/RockNES team.
  359.  
  360. *---------------------------------------------------------------------------*
  361.  
  362. ===========
  363.  IX. http  
  364. ===========
  365.  
  366. ■ Fx3's official RockNES Webpage at
  367.   http://www.emucamp.com/rocknes/
  368.  
  369. *---------------------------------------------------------------------------*
  370. eof
  371.